home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-06
/
bt515.exe
/
BTOOLS
/
XTRAP.DOC
< prev
next >
Wrap
Text File
|
1991-04-17
|
4KB
|
128 lines
README FOR XTRAP.EXE : Smart NetWare SQL Trace Utility
XTRAP.EXE is a TSR that will trap API calls between a front-end application and
NetWare SQL or XQL. The user may specify specific API functions to trap or
trap them all. Once trapped, the data may be viewed on the computer display or
written to a log file. XTRAP will provide an intelligent display of the
parameters specific to the trapped call. Comments may be added to the log file
at any time from the pop-up menus.
General Features:
- Quick display of XTRAP status at any time.
- Select a Pass Count to pass over API calls.
Display Features:
- Display data before the API call is sent, after the API call returns,
both, or neither.
- XTRAP will display each parameter of the API call. You may select any
of the parameters and scroll through a memory dump.
Log Features:
- Write to the log file before the API call is sent, after the API call
returns, both, or neither.
- Change the log filename at any time. Overwrite or append to an existing
log file. The default log file name is "xtrap.log".
- Write a memory dump to the log file before the API call is sent, after
the API call returns, both, or neither. Two sample log files are included
with XTRAP: one with a data memory dump-->"withdump.log", and one
without-->"nodump.log".
- Specify the number of memory dump lines to be written to the log file.
- Specify a maximum size for the log file (start over when size is reached).
Size = 0 will set file size to "NO LIMIT"
- Add a comment to the log file at any time.
API Selection Features:
- Trap all of the API calls.
- Trap None of the API calls.
- Select specific API calls to trap.
- Trap unknown API calls (fcn = -1).
*******************************************************************************
USAGE:
One of the following NetWare SQL Requesters or XQL programs must be loaded
before XTRAP: NSREQ, NSREQS, XQL, XQLO, XQLP, XQLPO.
Load XTRAP with the /r parameter. (XTRAP /r)
Unload XTRAP with the /x parameter. (XTRAP /x)
To activate XTRAP's window display, hit the L-Ctrl, L-Shift, and X keys
simultaneously.
Menu options:
-------------
To toggle menu options, type the highlighted letter of the menu option until
the appropriate option is highlighted. Following is a list of options:
MAIN MENU: XTRAP.EXE NetWare SQL Trace Utility
d: DISPLAY MENU:
d: eNable or Disable the displaying of trapped API's
m: select when to display trapped API
l: LOGGING MENU:
l: enable or disable all logging
f: change the log file name
m: select when to log trapped API call
d: enable or disable memory dump (only while logging)
u: select wheN to log memoRy Dump of trapped API parameters
n: enter the Number of memoRy Dump lines for the log file
s: enter the maximum size for the log file - after the size
has been reached it will start the log file over.
SIZE = 0 --> no size limit.
c: add a single line comment to the current log file
s: API SELECTION MENU:
a: set all API's as "trap"
n: set all API's as "do not trap"
s: set specific API's as "trap" or "do not trap"
u: trap unknown API's (ex. fcn# -1)
p: SET PASS COUNT: set number of API calls to pass
c: CONFIGURATION FILE: save/load configuration file (NOT AVAILABLE YET).
NOTE: If the user tries to create a log file in an area where he or
she does not have write privileges, the file will not be created
and the log mode will be set to "Disabled"
********************************************************************
DISCLAIMER
Xtrap is provided as is and carries no warranty whatsoever. Novell
disclaims and excludes any and all implied warranties of
merchantability, title and fitness for a particular purpose. Novell
does not warrant that the software will satisfy your requirements
or that the software is without defect or error or that operation of
the software will be uninterrupted. You are using the software at
your risk. The software is not a product of Novell, Inc. or any
subsidiaries.
********************************************************************